package site.isscloud.project.mapper;

import java.util.List;

import org.apache.ibatis.annotations.Param;
import site.isscloud.project.domain.PjLocationMarker;

/**
 * 空间位置标记Mapper接口
 *
 * @author junhuang
 * @date 2025-10-14
 */
public interface PjLocationMarkerMapper
{
    /**
     * 查询空间位置标记
     *
     * @param id 空间位置标记主键
     * @return 空间位置标记
     */
    public PjLocationMarker selectPjLocationMarkerById(Long id);

    /**
     * 查询空间位置标记列表
     *
     * @param pjLocationMarker 空间位置标记
     * @return 空间位置标记集合
     */
    public List<PjLocationMarker> selectPjLocationMarkerList(PjLocationMarker pjLocationMarker);

    /**
     * 查询所有有效空间位置标记
     *
     * @return 列表
     */
    public List<PjLocationMarker> selectAllActive();

    /**
     * 新增空间位置标记
     *
     * @param pjLocationMarker 空间位置标记
     * @return 结果
     */
    public int insertPjLocationMarker(PjLocationMarker pjLocationMarker);

    /**
     * 修改空间位置标记
     *
     * @param pjLocationMarker 空间位置标记
     * @return 结果
     */
    public int updatePjLocationMarker(PjLocationMarker pjLocationMarker);

    /**
     * 删除空间位置标记
     *
     * @param id 空间位置标记主键
     * @return 结果
     */
    public int deletePjLocationMarkerById(Long id);

    /**
     * 批量删除空间位置标记
     *
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deletePjLocationMarkerByIds(Long[] ids);

    /**
     * 通过空间编码查询空间位置标记
     *
     * @param lcCode 空间编码
     * @return 空间位置标记列表
     */
    public List<PjLocationMarker> selectPjLocationMarkerByLcCode(String lcCode);

    /**
     * 通过设备编号和通道号查询空间位置标记
     *
     * @param deviceNo 设备编号
     * @param channelNo 通道号
     * @return 空间位置标记列表
     */
    public List<PjLocationMarker> selectPjLocationMarkerByDeviceAndChannel(String deviceNo, Integer channelNo);

    /**
     * 根据父级位置代码查询所有子级标记数据
     *
     * @param parentCode 父级位置代码
     * @return 子级标记列表
     */
    List<PjLocationMarker> selectChildMarkersByParentCode(@Param("parentCode") String parentCode);

    /**
     * 根据米标范围查询对应的楼层标记
     *
     * @param parentCode 父级位置代码
     * @param meterMark 米标
     * @return 楼层标记
     */
    PjLocationMarker selectMarkerByMeterRange(@Param("parentCode") String parentCode, @Param("meterMark") Integer meterMark);
}